home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / usrchk31.zip / USERCHEK.DOC < prev    next >
Text File  |  1993-01-18  |  14KB  |  369 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                    SYSOP DOCUMENTATION USERCHEK
  11.  
  12.                              for the
  13.  
  14.                       IBM Personal Computer
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                by
  21.  
  22.                             John Krytus
  23.                          246 Gardner Avenue
  24.                        Northwood, Ohio 43619
  25.                        Voice (419) 691-9700
  26.                        Data  (419) 691-1125
  27.  
  28.                            December 1992
  29.  
  30.  
  31. Disclaimer
  32. ----------
  33. Thank you for using USERCHEK.   PLEASE NOTE USERCHEK is NOT public domaine
  34. software.   It Is Shareware.   To use program constitutes agreement to
  35. register this software.  If you do not use this software please pass it
  36. on for others to use. IN UNMODIFIED FORM.  If you use it, YOU MUST
  37. REGISTER IT.    ANY USE WITHOUT REGISTRATION CONSTITUTES FRAUD.
  38.  
  39. This product is provided "As Is" with no warranty, either expressed or
  40. implied.  All risk when running this product is with you.
  41.  
  42. 1.0 Program Description
  43. -----------------------
  44. This file will take control of your bbs and callback users to
  45. verify they are who they say they are.  Userchek is strictly
  46. written for RBBS.  It uses whatever user interface files that
  47. are provided by rbbs.
  48.  
  49. 2.0 Required files
  50. ------------------
  51. You must have a batch file that you are running your RBBS from. 
  52.  
  53. The purpose of the files are as follows:
  54.  
  55. 1.      Userchek.exe    Main EXE program.
  56.  
  57. 2.      Userchek.doc    Documentation for Rbbs sysops.
  58.  
  59. 3.      Userchek.bat    Batch file to execute when rbbs exists
  60.                         to your door program.
  61.  
  62. 4.      Readme.now      Updates as they have occured.
  63.  
  64. 5.      Update.new      Check this file to see if there are any
  65.                         special instructions in installing update.
  66.  
  67.  
  68. 3.0 Setup
  69. ---------
  70. Normally, making a userchek subdirectory off of your rbbs
  71. subdirectory is the best way to set up this door.  Do this
  72. by typing MD USERCHEK in the rbbs subdirectory.  Recommended
  73. directory tree for the program is as follows:
  74.  
  75.         C:\RBBS\USERCHEK
  76.  
  77. Setting up this door is easy as all you have to do is invoke
  78. the userchek.exe program.  You will be asked to enter various
  79. locations for files.  There are suggested defaults that you
  80. might want to accept. The following questions will be asked.
  81. To get to this process, it is recommended that to type:
  82.  
  83.         C:\RBBS\USERCHEK>USERCHEK LOCAL
  84.  
  85. It is recommended that you run in the local mode for the first
  86. time as you will probably get an error when userchek tries to
  87. access your com port.  Also, running the door in the LOCAL mode
  88. will give you a chance to see what will be dialed for various
  89. numbers and combinations enterd.
  90.  
  91. 1.      Enter the name and location of the dorinfo file.
  92.  
  93.         Normally, the location of this file is the same as the
  94.         location of rbbs-pc.exe.  Rbbs creates this file when
  95.         it goes to a door.  If you press return, the default
  96.         will be used.
  97.  
  98.         If the Dorinfo file cannot be found, userchek will
  99.         create one for you in order to check out local operation.
  100.         But ultimately, rbbs makes this file new for each caller.
  101.  
  102. 2.      The next question will ask you to enter the name of
  103.         door control file rbbs uses to adjust the user's
  104.         security.
  105.  
  106.         Normally, this file is named DOUT1.DEF.  Userchek
  107.         makes this file when returning to rbbs thereby,
  108.         adjusting the user's security level.
  109.  
  110.         We have found that if using the long distance verify,
  111.         and userchek disconnects the caller, rbbs checks for
  112.         carrier before it checks for the doutX.def.  I have
  113.         asked the authors of Rbbs to change this but as of
  114.         yet, have NOT gotten it changed.
  115.  
  116. 3.      The next question will ask you if you want your bbs
  117.         to be calling long distance.  With this version, sysops
  118.         can choose whether they want LD or local users connected
  119.         after a valid callback.
  120.  
  121. 4.      The next question asks what the security level is that
  122.         will invoke the door to verify callers.  On my system
  123.         it is -3-.  Enter whatever security level you wish
  124.         here.
  125.  
  126. 5.      Here, enter the level of security to assign to the
  127.         caller should the caller pass the verify callback.
  128.  
  129. 6.      Enter the location and filename where a log will be
  130.         kept of user verify tries.  Hitting enter will accept
  131.         the default.
  132.  
  133. 7.      This entry of a filename keeps track of the trash
  134.         numbers you want to check before your system dials.
  135.  
  136. 8.      This file keeps track of the numbers that were
  137.         successfully verified.  If a users phone number is in
  138.         this file, it will not be called again.
  139.  
  140. 9.      The is the opportunity for you to enter a string to
  141.         be sent to the modem just before the phone number
  142.         is dialed.  The default is ATM1 which turns the modems
  143.         speaker on.
  144.  
  145.         At this point you might not want the speaker on so
  146.         enter ATM0, which turns the speaker off.  Having no
  147.         effect cause it's off already.
  148.  
  149.         If you run a hi-speed modem and it supports error checking,
  150.         you might want to disable that part of your modems pre-
  151.         connect modem to modem negotiation sequence.  Use the
  152.         sequence atm1&m0.  The m1 sets the speaker condition,
  153.         whether on or off.  The &m0 turns off the mnp error
  154.         connect sequence.  If you do not turn off this error
  155.         control, when the caller is called back, a plash of garbage
  156.         characters will be seen at the remote end.
  157.  
  158. 10.     You are asked here for the path/filename for the file
  159.         to post area codes that require special dialing options.
  160.         There are many areas of the country that are doing crazy
  161.         things in terms of dialing.  Hopefully, this addition to
  162.         userchek will encompass these problems.
  163.  
  164. 11.     This question enables the exclusive callback feature of
  165.         userchek.   When this function is enabled, userchek will
  166.         only callback the prefixes listed in the data file.
  167.  
  168. 12.     Enter the name here for the exclusive callback prefix file.
  169.  
  170.  
  171. 4.0 Running the Doorware program
  172. --------------------------------
  173. After  completing  the  setup as stated above insure that items
  174. #107 and #108 are completed.
  175.  
  176. Item #107 requests the name and location of the file to be invoked
  177. by rbbs when the verification takes place.   Be sure to type in the
  178. entire drive PATH and FILENAME with EXTENSION.
  179.  
  180.         ie.  c:\rbbs\userchek.bat
  181.              |  |    |        |
  182.              |  |    |        |_ File Extension
  183.              |  |    |
  184.              |  |    |_ Filename
  185.              |  |
  186.              |  |_ Path
  187.              |
  188.              |_ Drive
  189.  
  190. Item #108 requests the security level to watch for to invoke the
  191. verify program.
  192.  
  193. Userchek is invoked by the running of the batch file userchek.bat
  194. by rbbs.  Typical userchek batch file would be as follows:
  195.  
  196. NOTE:  You must not invoke a watchdog program to check for carrier
  197.        as this will reboot your machine during the callback process.
  198.  
  199. echo Please Standby....... > com1
  200. cd userchek
  201. userchek 1
  202. cd..
  203.  
  204. Line#1 of this file will send a message to the caller to please
  205. standby.  Change the comm port if applicable.
  206.  
  207. Line #2 points to the userchek directory to run the userchek
  208. program.
  209.  
  210. Line#3 invokes the userchek program for the specific node.
  211.  
  212. Line #4 get us back to the rbbs subdirectory to give control back
  213. to rbbs.
  214.  
  215. You can run Userchek and NOT have it check for carrier by using
  216. the word LOCAL on the command line when starting it up.  During
  217. normal operation, the word local is not used.
  218.  
  219. You can provide caller security checking in the form of lower, equal,
  220. and more than required for callback.  When rbbs passes control to
  221. userchek for callback, the userchek.def file has the newusers
  222. security level to be verified.  If the callers security level is
  223. lower than callback level, the caller must not have done something
  224. you wanted him to.  On my board, the caller must fill out the
  225. newuser questionnaire.  If the caller comes to userchek with the
  226. proper security level, he is passed to the callback program to be
  227. verified.  If the callers security level is more than the newuser
  228. callback level, you must now want the caller verified and they will
  229. be passed back to rbbs with the higher security level.
  230.  
  231. 5.0 Installation Summary:
  232. ------------------------
  233. I had to change my old user's security level to something less
  234. than 9 so that rbbs would run them thru the callback door. This
  235. might be the most time consuming part of this project.
  236.  
  237. TYPICAL OPERATION:
  238.  
  239. 1.   Caller logs on BBS.  If security level is below level set for
  240.      verification, rbbs asks users if they want to register.  If
  241.      they do, rbbs asks them to do newuser questionnaire.  After
  242.      questionairre, rbbs exits rbbs to the userchek program.
  243.  
  244. 2.   After userchek takes over, it gives users the necessary inform-
  245.      ation in order to complete the registration callback.
  246.  
  247. 3.   The callback routine generates a random 5 digit number.  The
  248.      caller is asked to write this number down and remember it.  Then
  249.      the users screen is erased and they are asked to key in the 5
  250.      digit number in again.  If successful up to this point, the
  251.      callback door disconnects the user and attemplts to call back.
  252.  
  253. 4.   If the connection is established, the callback routine asks the
  254.      user to enter the 5 digit number.  If the numbers match, the
  255.      callback routine gives control back to rbbs and the users sec
  256.      level is raised to the level specified in the  program init
  257.      part.
  258.  
  259.  
  260.  
  261. 6.0 Registration
  262. ----------------
  263. When you $25.00 to register your copy of userchek, I will give you
  264. a registered version of the program.  The registered version will
  265. display your name when it comes up and it will also write verified
  266. users to the file called verified.dat. What has been working for me
  267. is that I will make your updated version available on my bbs.  I have
  268. been trying to get the registered versions distributed by uploading
  269. them to the registered users board.  But this is getting out of hand.
  270.  
  271. Also, there is no fee for updating a registered copy so your paying the
  272. LD call sounds fair to me.
  273.  
  274. I have been pretty good about helping sysops get userchek running with
  275. bbs messaging and voice phone calls.
  276.  
  277. 7.0 Help
  278. --------
  279. I have a 24 hour bbs online.  If you have comments or questions
  280. give me a call.  The bbs now supports 14.4k Dual Standard calls.
  281.  
  282. 8.0 Multi-user Operation
  283. ------------------------
  284. In order to run this door multiuser, one must set up a usrchk?.def
  285. for each node to be accessed by userchek.
  286.  
  287. For Instance, node 1's def file would be usrchk1.def and node 2's
  288. def file would be usrchk2.def.
  289.  
  290. Specify the dorinfo1 or dorinfo2 file as appropriate.
  291.  
  292. 8.0 Desqview support
  293. --------------------
  294. There has been requests for userchek to behave better when used in
  295. the Desqview environment.  Well, I have done just that by way of
  296. an option that can be used on the command line when invoking the
  297. program.  Typical usage would be as follow:
  298.  
  299. C:\>Userchek 1 DV
  300.  
  301. The above command line would ask userchek to use com port 1 and also
  302. display information so that Desqview could redirect it.
  303.  
  304. 9.0 Variation in Ld dialing
  305. ---------------------------
  306. Some local phone companies have started using area codes without
  307. dialing a '1'.  ie.  Washington DC, using 202, 301, 703.  If you
  308. are in 202 and want ot dial a number in 703 area, you need to dial
  309. the 703 also.  Userchek now provides a very powerful data file to
  310. select dialing options.
  311.  
  312.          Ld code file format
  313.          XXX-XXX-XXXX, 1, N, ATDT
  314.          ***-***-****  *  *  ****
  315.          |             |  |  Dialing Prefix
  316.          |             |  Ld flag
  317.          |             Dial Format
  318.          Phone Number entered by user
  319.  
  320.          Dial Format
  321.          1 - Dial             [pre] [suffix] - Stay connected
  322.          2 - Dial         1 - [pre] [suffix] - Stay connected
  323.          3 - Dial        [ac] [pre] [suffix] - Stay connected
  324.          4 - Dial    1 - [ac] [pre] [suffix] - Stay connected
  325.  
  326.          5 - Dial             [pre] [suffix] - disconnect
  327.          6 - Dial         1 - [pre] [suffix] - disconnect
  328.          7 - Dial        [ac] [pre] [suffix] - disconnect
  329.          8 - Dial    1 - [ac] [pre] [suffix] - disconnect
  330.         
  331. When userchek initially establishes the Ldcode.dat file, it creates
  332. file with two entries in it as follows.
  333.  
  334.             "XXX-XXX-XXXX,4,Y,ATDT"
  335.             "XXX-XXX-XXXX,1,N,ATDT"
  336.  
  337. The first entry addresses the long distance calls.  It will use
  338. the 4th dial format for any long distance calls.  Course if you
  339. don't want LD calls, Answer 'N' to the LD question when making
  340. the usrchk?.def file.
  341.  
  342. The second entry deals with local calls are their dial format.
  343. The 'X' in the phone number means 'don't know the number and
  344. don't care what it is'.
  345.  
  346. Specialized dialing instructions can now be checked in the local
  347. mode as userchek displays the number and whether it is to stay
  348. connected or disconnected when dialed.
  349.  
  350. 10.0 Exclusive Dialing
  351. ----------------------
  352. This feature handles the bbs sysop that can dial long distance
  353. 7 digit number sequences without a '1'.  There are so many dial
  354. options here that I decided to provide a data file that will
  355. restrict dialing to just the prefixes in this file.  Hope it helps!
  356.  
  357.  
  358. 11.0 Color
  359. Was able to ge the ega and vga color working.  Ansi also works if
  360. the caller has chosen the graphics selection in rbbs.  If you want
  361. to disable the local color, invoke userchek with /b on the command
  362. line.
  363.  
  364. 12.0 Future Plans
  365. -----------------
  366. I am currently working on a version to use a fossil driver.  Should
  367. be done by Christmas 1992.
  368.  
  369.